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1 . INTRODUCTION 



This document describes the differences between BASIC/RT-11 VOlB and 
BASIC-ll/RT-11 V2. It also lists some restrictions you should be 
aware of when using BASIC-il/RT-ii V2. This document describes the 
procedure you should follow to install BASIC-11 on your RT-11 V03 
system. Lastly, it shows how to use the program SUCVT to convert 
BASIC/RT-11 VOIB programs to a format suitable for BASIC-ll/RT-11 V2. 

The following documentation conventions are used throughout this 
manual: 

1. Square brackets I J enclose optional items. 

2. Braces ] | enclose items from which you must choose only one. 

3. Upper case letters represent keywords that you must type as 
shown. 

4. Lower case letters represent variables for which you supply 
values. 

5. Ellipses ... indicate that the immediately preceding item 
can be repeated. 

6. User input is underlined where necessary to distinguish it 
from computer printout. 

7. The abbr'eviation "expr" represents expression. 

8. The symbol (ret) represents a carriage return. 



2.0 CHANGES FROM BASIC/RT-11 VOIB 

This section summarizes the differences between BASIC/RT-11 VOIB and 
BASIC-ll/RT-11 V2. You can find more information on BASIC-ll/RT-11 V2 
in the following two documents: 

BASIC-11 Language Reference Manual 
Order No. DEC-11-LIBBB-A-D 

BASIC-ll/RT-11 User's Guide 

Order No. DEC-11-LIBUA-A-D 

For more information on the RT-11 V03 operating system, consult the 
following guide: 

RT-11 Documentation Directory 

Order No. DEC-11-ORDDB-A-D 

Table 1 lists the new features of BASIC-ll/RT-11 V2. 
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Table 1 
New Features of BASIC-ll/RT-11 V2 



Category 


Name 


Integer Data Type 


- 


Double Precision Data Type 


- 


Statements 


COMMON 




DIM# 




KILL 




LINPUT 




NAME 




ON GOTO 




ON GOSUB 




ON THEN 




PRINT USING 




RESET 


Functions 


ABORT 




CTRLC 




LOGIO 




PI 




RCTRLC 




RCTRLO 




SYS 




TTYSET 


Commands 


APPEND 




BYE 




COMPILE 




DEL 




LENGTH 




RESEQ 




SUB 




UNSAVE 




CTRL/Q 




CTRL/S 



Some statements, functions, and commands are not entirely new in 
BASIC-ll/RT-11 V2, but have syntactical or functional differences from 
their counterparts in BASIC/RT-11 VOIB. Tables 2, 3, and 4 list both 
the old and new statements, functions, and commands. The tables also 
provide a brief explanation of the changes. 
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Version 



VOlB 
V2 



Table 2 
Changes in Statements from 
BASIC/RT-11 VOlB to BASIC-ll/RT-11 V2 



Statement 



CALL |"| routine name["]l [{argument list)] 

In V2, the quotation marks delimiting the routine names 
are optional. 



VOlB 
V2 



CHAIN "string" LINE number 

CHAIN string |LINE expression] 

In V2, the line number specification can be an 
expression. 



VOlB 



V2 



VOlB 
V2 



fjVFnil 

CLOSE |< )\ 

Ll#n )J 

CLOSE [l#J exprl, [#lexpr2, [#] expr3, . . .] 

In V2, the pound sign (#) is optional. You can specify 
more than one file, and the file specification can be 
an expression. The VFn syntax is no longer permitted. 

DATA list 
DATA list 

In V2, unquoted strings are permitted. The DATA 
statement must be . the last statement on a 
multi-statement line. 



VOlB 



V2 



DEF FNletter (varl [,var2, . . .var5] )=expression 

DEF FNletter |< >B (varl t,var2, . . . ,var5J )=expression 



ii;ii 



In V2, if the function returns a string, the function 

name (FNletter) must end with a dollar sign ($) . If 

the function returns an integer, the function name must 
end with a percent sign (%) . 



VOlB 



(THEN 
IF relational expression { } line number 



t 



GO TO 



I THEN ) 
>line number 
GO TO) 



(continued on next page) 
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Version 



V2 



VOIB 
V2 

VOIB 
V2 



VOIB 



V2 



VOIB 



V2 



Table 2 (Cont.) 
Changes in Statements from 
BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Statement 



IF relational expressio 



IF END #expr 



■I 

I THEN statement | 
THEN line number > 
GO TO line number) 



THEN statement j 
THEN line number | 
GO TO line number) 



In V2, the THEN keyword can be followed by a statement 
as well as by a line number. 

INPUT variablel|[,variable2, . . J 

INPUT |[#expr,l variablel[,variable2, . . .] 

In V2, you can type more than one string on a line. 

INPUT #expr: var iablel [,variable2, . . .] 

INPUT [#expr ,] var iablel [, var iable2 , . . .] 

DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 
colon is still permitted. 

[let] variable=expression 

[[LET] VFn(i)=expression 

fLET] variable=expression 

In V2, the VF format is not permitted. 

[(INPUT )11 T T. 

FOR { [ [(b)] AS FILE #digit [DOUBLE BUF| 
( output)] 



(INPUT I 



|(b)|AS FILE VFdigit (dimension) =string length 



OPEN string 



FOR INPUT \\\ ^g pj^ l^j gjjpj. |doublE BUf] 



FOR OUTPUT) 
[,PECORDSIZE exprj |,MODE exprj 



,FILESIZE expr 



In V2, the file specification can be any string 
expression. The pound sign (#) is optional. Specify a 
file size by using the FILESIZE keyword. The VF format 
is not permitted. 



(continued on next page) 
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Table 2 (Cont.) 

Changes in Statements from 

BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Version 


Statement 


VQIB 


OVERLAY "file descriptor" 


V2 


OVERLAY string fLINE expression] 




In V2, the line number specification can be an 




expression. 


VOIB 


PRINT #expr: list 


V2 


PRINT [#expr,] [list] 




DIGITAL recommends that you follow the expression by a 
comma (,) rather than by a colon (:), even though the 
colon is still permitted. 


VOIB 


RANDOMIZE 


V2 


RANDOMIZE 




In V2, the random number generator starts at a new 
number each time the statement is executed. 


VOIB 


REM comment 


V2 


REM comment 




In V2, you can terminate a comment by a backslash (\) . 



Table 3 

Changes in Functions from 

BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Version 


Function 


VOIB 


ASC (string) 










V2 


ASC (string) 












In V2, this function returns 


an 


8-bit 


(rather 


than 




7-bit) value. 










VOIB 


BIN|(]string[)] 











(continued on next page) 



BASIC-ll/RT-11 INSTALLATION GUIDE 



Table 3 (Cont.) 

Changes in Functions from 

BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Version 


Function 


V2 


BIN (string) 




In V2, the parentheses delimiting the argument are 
required. 


VOIB 


CHR$(expr) 


V2 


CHR${expr) 




In V2, this function accepts an 8-bit (rather than 
7-bit) value. 


VOIB 


OCTKJstringE)] 


V2 


OCT (string) 




In V2, the parentheses delimiting the argument are 
required. 


VOIB 


STR${expr) 


V2 


STR$(expr) 




In V2, this function can return more than six digits 
(with double precision arithmetic). 



Table 4 
Changes in Commands from 
BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Version 


Command 


VOIB 


LISTINHI 




LISTINHJline number 




LISTINHJ-line number 




LISTINHI line number - lENDj 




LISTINHJline number - line number 


V2 


LIST [NH] [line specif icationl, line specif ication2, .. .^ 




In V2, you can list more than one line range 




specification. The END specification is no longer 




allowed. The other VOIB forms of the command are still 




valid in V2. 



(continued on next page) 
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Table 4 (Cont.) 
Changes in Commands from 
BASIC/RT-11 VOlB to BASIC-ll/RT-11 V2 



Version 


Command 


VOi 


NEW "program name" 
OLD "file specification" 
RENAME "program name" 
REPLACE "file specification" 
SAVE "file specification" 


V2 


NEW [program namej 
OLD [file specification] 
RENAME program name 
REPLACE file specification 
SAVE [file specification] 




In V2, these commands must not contain quotation marks 
that delimit the file specifications. 


VOIB 


RUN 
RUNNH 


V2 


RUN [NH] 

RUN[NH] file specification 




In V2, you can include a file specification in the RUN 
and RUNNH commands. 


VOIB 


CTRL/C 


V2 


CTP.L /Q. 




In V2, CTRL/C returns control to BASIC (in VOIB, it 
returned control to the RT-11 monitor) . CTRL/C also 
prints the line number of the line that was executing 
when it interrupted the program. 



Table 5 lists changes in miscellaneous features from BASIC/RT-11 VOIB 
to BASIC-ll/RT-11 V2. 
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Table 5 
Changes in Miscellaneous Features from 
BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Feature 



Change 



Maximum line 
number 



String concate- 
nation operator 



Virtual arrays 



Terminal width 



Closing files 



Deleting a character 



Deleting a line 



Lower case 



In V2, the maximum line number is 32767 (in 
VOIB, it was 65532) . 



In V2, the string concatenation operator 
can be either the ampersand (&) or the plus 
sign {+) (in VOIB it was the ampersand). 



In V2, virtual arrays are 1 
memory (except that they ar 
run time); they do not 
variable names. Virtual 
one or two subscripts (VOIB 
one subscript). The string 
any value between 1 and 255; 
have to be a power of 
string length is 16 (in VOIB 



ike arrays in 

e not zeroed at 

have special 

arrays can have 

allowed just 
length can have 

it does not 
2. The default 
, it was 32) . 



In V2, the terminal width can be set from 1 
to 255 characters. See the BASIC-ll/RT-11 
User's Guide for a description of the 
TTYSET function. 



In V2, files are closed by the CLOSE or END 
statement (or by execution of the last line 
of the program) but are left open by the 
STOP statement. Any open output files are 
deleted by the RUN, SCR, OLD, and NEW 
commands. (In VOIB, STOP, RUN, SCR, OLD, 
and NEW closed files.) 



In V2, the DELETE (or RUBOUT) key deletes a 
character; the backarrow (or underscore) 
key does not. (Both DELETE and backarrow 
were valid in VOIB.) 



In V2, the CTRL/U command deletes a line; 
the ESCAPE (or ALTMODE) key does not. 
(Both CTRL/U and ESCAPE were valid in 
VOIB.) 



In V2, lower case keywords and variable 
names are always converted to upper case. 
Lower case string constants and remarks are 
permitted. 



(continued on next page) 
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Table 5 (Cont.) 
Changes in Miscellaneous Features from 
BASIC/RT-11 VOIB to BASIC-ll/RT-11 V2 



Feature 



Change 



Arithmetic hardware 
support 



CALL interface 



BASIC-ll/RT-11 V2 supports the following 
hardware (VOIB also supported this 
hardware) : 

EAE KEll-A and KEll-B 

Extended Arithmetic Element 

EIS KEll-E 

Extended Instruction Set 

FPU FPll-A, FPll-B, and FPll-C 
Floating Point Unit 

Support of the following hardware is new in 
V2: 

FIS KEll-P 

Floating Point Instruction Set 

KEV-11 

Extended Arithmetic Element 



In V2, the CALL interface is similar to the 
FORTRAN IV CALL interface. Note that 
arrays are stored with the second subscript 
varying faster; they are stored 
independently of the scalar with the same 

offsets have changed. See the 
BASIC-ll/RT-11 User's Guide for a complete 
description of the CALL interface. 



3.0 RESTRICTIONS IN BASIC-ll/RT-11 V2 

BASIC-ll/RT-11 users should always keep abreast of BASIC-related 
notices published by DIGITAL. Changes published in the Software 
Performance Summary need be made only once and should be made 
immediately. Changes published in the Digital Software News should be 
made as soon as possible to systems in use. The following sections 
summarize the restrictions in BASIC-ll/RT-11 V2 of which you should be 
aware. 



3.1 Floating Point Operations 

Since whole floating point numbers are not stored as integers, 
execution of floating point operations can be slower than in VOIB, in 
certain circumstances. To avoid this problem, convert the data from 
floating point to integer by specifying the percent sign {%) wherever 
possible. 
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3.2 READ Statement 

Since a list created by a data statement is stored in ASCII format 
(rather than in a binary internal format) , the READ statement requires 
additional time to translate data items. 



3.3 REM Statement 

A REM statement terminated by a backslash (\) gets longer by one space 

each time a program containing it is saved by the SAVE command. If a 

program containing such a line is called and saved (with the OLD and 
SAVE commands) several times, the line can become too long for BASIC 

to handle properly. Use the SUB command to delete the extra spaces 
before the line gets too long. 



3 . 4 Subset ipts 

BASIC calculates subscripts by performing an INT function rather than 
by using true truncation. This method of calculating subscripts 
causes no problems with positive subscripts. It also causes no 
difficulty with subscripts of -1 or less, since BASIC does not support 
negative subscripts. However, BASIC does give an error (7SUBSCRIPT 
OUT OF BOUNDS) for A (-.5). 



3.5 GOSUB Statement 

An immediate mode GOSUB to a routine that has an INPUT or LINPUT 
statement can crash BASIC, under certain circumstances. This can 
occur because BASIC uses the same area of memory to process both 
immediate mode statements and terminal input. When BASIC returns 
control to the line with the immediate mode GOSUB statement, that line 
has been overwritten by the terminal input (from the INPUT or LINPUT 
statement) . To avoid this problem, use an immediate mode GOTO 
statement in place of the GOSUB statement. This causes BASIC to 
execute the subroutine, print a warning, and then print the READY 
message. 



3.6 COMPILE Command 

The COMPILE command generates a file with a .BAC file type under BASIC 
with single precision arithmetic. Similarly, it generates a file with 
a .BAX file type under BASIC with double precision arithmetic. If you 
use an OLD, RUN, or CHAIN command to call a .BAC file under double 
precision BASIC or a .BAX file under single precision BASIC, BASIC can 
crash. You must explicitly specify the wrong file type to create this 
problem. BASIC executes properly when you rely on default file types. 



3.7 File Types 

When you call a file (with an OLD, RUN, or CHAIN command) , BASIC looks 
first for a compiled image, and then for a .BAS image. If, for 
example, you specify OLD X.BAC and X.BAC does not exist, 
BASIC-ll/RT-11 V2 continues to search for the .BAS file. 



10 
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3.8 Device Handlers 

If a BASIC program that contains an array resides on a device whose 
handler is not resident, references you make to that device (with the 
OPEN statement, or the CHAIN command, for example) can cause the 
system to crash. Be sure to load the appropriate device handler to 
avoid this problem. 



3.9 OPEN Statement 

When BASIC opens an integer virtual array, and the subscript you 
specify in the DIM# statement is 1 or 2 less than a multiple of 256, 
BASIC creates a file that is one block too long. 



3.10 Reading a String 

If you place a null string as the last item in a DATA statement or an 
input line, indicate it by two adjacent quotation marks. The 
following example shows two null strings: one is indicated by two 
adjacent commas, and the other by two adjacent quotation marks. 

10 DATA 5fABC>6» rDEF»"" 



4.0 INSTALLATION PROCEDURE 

The BASIC-ll/RT-11 V2 software kit contains three running versions of 
BASIC: 



1. 


BASIC. SAV 


2. 


BAS8K.SAV 


3. 


BASICD.SAV 



The BASIC. SAV version includes all the optional features except the 
CALL statement. It is overlaid (it has overlay type 3) and does not 
include support for arithmetic hardware. Its base address is 1000. 

The BAS8K.SAV version can execute in 8K words of memory. It should 
only be used for 8K RT-11 systems. It does not include the following 
optional features: 

1. PRINT USING statement 

2. SUB command 

3. CALL statement 

4. RESEQ command 

5. Long error messages 

BAS8K is overlaid (it has overlay type 5) and does not include support 
for arithmetic hardware. In addition, BAS8K has a base address of 
700. 

BASICD.SAV has the same features and overlay type as BASIC. SAV. It 
supports double precision floating point arithmetic and has a base 
address of 1200. 



11 
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4.1 Linking BASIC 

If BASIC. SAV, BASICD.SAV, or BAS8K.SAV is suitable for your 
application, you do not need to relink BASIC. However, you can link 
BASIC to make any of these changes: 

1. Change the overlay type 

2. Add support for arithmetic hardware 

3. Add CALL support and assembly language routines 

4. Add or remove any optional features 

To link BASIC, you must run the program SUCNFG.BAS. This program asks 
you questions about BASIC'S features and optional support. Then it 
creates an indirect command file that you must execute. This indirect 
file links BASIC according to the instructions you supplied to SUCNFG. 
The indirect file creates an executable version of BASIC (with any 
name you specify) that is tailored to your requirements. 

Read Sections 4.2 and 4.3 to learn how to use the dialogue program, 
SUCNFG. Then read Section 4.4, which describes how to transfer the 
necessary files for linking BASIC from the software kit to your 
system. 



4.2 Using the Dialogue Program 

To invoke the dialogue program, you must first run BASIC. Then run 
SUCNFG: 

. R BASIC (SB) 

BASIC-11/RT~11 V02-02 

OPTIONAL FUNCTIONS (ALL» NONE» OR INDIVIDUAL)?® 

READY 

RUN SUCNFG (Sll) 

BASIC~11/RT~11 V02 Conf isfuration ProSrsm 

Type "?<ret>" after any promFt for HELP. 

.SAV and .COM file name (default is BASIC) J 

When the dialogue prompts you for a .SAV and .COM file name, enter the 
name of the BASIC version you want to create. If you type only the 
RETURN key, the new version of BASIC is called BASIC. SAV. Note that 
if the new version is called BASIC. SAV, it replaces the version you 
are currently running. The listing shown in Figure 1 contains all the 
questions in the dialogue program, along with brief explanations. 
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♦SAV and ♦COM file name (default is BASIC) J 

Enter the name in 6 or less characters for the name to be 
aiven to the .SAV ima^e of BASIC and the indirect file 
to be used to build BASIC* 

Do uou want a map? (Y or Hi default is N){ 

Type Y for yes or N for no. If the answer 
is Yt the next auestion will ask for a name. 

♦ MAP name (default is same as .SAV name)? 

Enter <ret> or any lesfal file name. 

Background or Foreground ? (B or Fr default is B){ 

B creates a .SAV imaSe to be run in the background. F creates 
a .REL imasfe to be run in the foresiround. 

Do you want PRINT USING? (Y or Hi default is Y): 

Y includes the PRINT USING optionr N does not. 

Do you want CALL support? (Y or Hi default is N)J 

Y includes CALL support* N does not. If CALL support is 
included the next auestion will handle the modules to 
be used with CALL in this BASIC. 

Enter module names (one per line) J 

On each line enter the name of a module to be included. Include your 
modified BSCLIi your subroutinesy and BSCLLB» if it is needed. 
When all the modules have been enteredi" type <ret> alone. 
For more information » please see the documentation on CALL. 

Single or Double precision math? (S or I>i default is S)» 

S creates a BASIC that supports the 2~word floating point 
representation. D creates a BASIC that supports the 4-word 
floating point representation. 

Arithmetic hardware (NONE» EAEr EIS- FISf or FPU» default is NONE): 

Arithmetic Hardware support is defined as follows? 

NONE - no arithmetic hardware is supported 

EAE - KEllA Extended Arithmetic Element is supported 

EIS - KEllE Extended Instruction Set is supported 

FIS - KEllF or KEVllF Floating Instruction Set is supported 

FPU - FPPllAr B» or C Floating Point Unit is supported 

Do you want the transcendental functions? (Y or Nf default is Y)} 

Y includes the transcendental functionsi- N does not. 
The transcendental functions are SQR» SINi> COS» ATN» 
LOG» L0G10» and EXP. 

Figure 1 The Dialogue Text 
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Do you want the SUB coirimsnd? (Y or Hr default is Y)! 

Y includes the SUB coaituandr N does not. SUB allows editing 
without retyping the entire BASIC statement. 

Do you want the RESEQ command? (Y or Nr default is Y)J 

Y includes the RESEQ command? N does not. RESEQ allows the 
reseouencins of line numbers in a BASIC program. 

Do you want lona error messages? (Y or Nf default is Y)J 

Y includes lonS error messasiesf N does not. 

Lon3 messages are several word explanations of an error 
condition. Short error messages are three character abbrevia- 
tions of the lond messages. 

Overlay structure type ( 1 1- 2t 3» 4!' or 5i default is 1)} 

The overlay structures are described as follows? 
Type 1 - BASIC is not overlaid. 
Type 2 - The error messaiSes are overlaid with a segment of 

of the edit phase. 
Type 3 - The error message phssei- edit phasec and the 

execute phase are overlaid. 
Type 4 - Similar to tape 3 except that the edit and execute 

Phases are overlaid internally. 
Tape 5 - Similar to type 4 except that the math package* the 
I/O routinesT are some other routines normally in the 
root segment are overlaid. 
The higher the overlay structure type number* the less memory 
is reouired by BASIC. The savinsf in memory reouirements is made 
at the expense of performance. Tape 2f however » has vera 
minimal effect on the performance of BASIC* with a substantial 
savina in memora if long error messages are used. Please see 
the documentation for more information. 



Figure 1 The Dialogue Text (Cent.) 



NOTE 

If you interrupt SUCNFG (with CTRL/C, 
for example) you must restart it from 
the very beginning by typing RUN SUCNFG. 



4.2.1 Overlay Types - The dialogue program lets you specify how your 
version of BASIC is to be overlaid. The listing reproduced in Figure 
1 summarizes the overlay types. Use overlay type 1 if conserving 
memory is not a concern on your system. Overlay type 2 is suitable 
for RK05 and RK06 systems where speed is more important than memory 
conservation. DIGITAL recommends type 2 for diskette-based systems. 
Overlay type 3 is suitable for RK05 and RK06 systems where memory 
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conservation is more important than speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay type 5. It has 
many small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 



4.2,2 Arithmetic Hardware Support - The versions of BASIC provided in 
the software kit do not support arithmetic hardware. Specify EAE if 
your system has the KEll-A or KEll-B Extended Arithmetic Element. Specify 
EIS to support the KEll-E Extended Instruction Set on a PDP-11/35 
or PDP-11/40. Use EIS also for any PDP-11/34, 11/45, 11/50, 11/55, 
or 11/70 without the FPU Floating Point Unit. Specify PIS if your 
system has the KEll-F or KEV-11 Floating Instruction Set. Specify FPU 
to include support for the FPU Floating Point Unit. Use FPU also for 
any PDP-11/60 even if it does not have the FPll-E Floating Point Unit. 



4.2.3 Foreground Execution - To link BASIC to execute in the 
foreground with either the FB or XM monitor, simply type an F in 
response to the dialogue program's "Background or Foreground?" prompt. 
To execute BASIC in the foreground, use the FRUN command with the /N 
option. You must use this option to ensure that your program has 
adequate memory space for foreground execution. Section 4.3 contains 
an example of linking BASIC and executing it in the foreground. 



4.2.4 Assembly Language Routines - The versions of BASIC provided in 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add the 
names of your assembly language routines to BSCLI.MAC, as described in 
the BASIC-ll/RT-ll User's Guide. Then assemble the three .MAC files 
together, supplying any file name for the resulting object file: 

. MACRO/OBJECT : HYCLI BSMAC4-BSftSM-l-BSCLI ^II) 

ERRORS detected: 

Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a Y in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC-ll/RT-ll User's Guide ). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 

Do you want CALL su^^F'a^t? <Y or Hr default is N): YCret) 

Enter module names (one per line)* MYCLI @l) 

Module name: MQDlg JET) 

Module name: MQD2^0 

Module name: M0D3^a ) 

Module name: MQD4(Bil) 

Module name: BSCLLB (ill) 

Module name: (ret) 
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4.2.5 Optional Features - You can link BASIC to add or delete support 
for any optional features. See the BASIC-ll/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at 
link time. 



4.3 Sample Dialogue 

The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
^"" u^l ^^^ foreground. This example also requests a wide map listing 
(with /W) , and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 

. R BASIC€1D 

BASIC-ll/RT-ll V02-02 

OPTIONAL FUNCTIONS (ALL» NONEr OR INDIVIDUAL)? A @t) 

READY 

RUN SUCNFG(bIi) 

BASIC-ll/RT-ll V02 Conf isuration Prodram 

Tyfe "T^ret:::" after any F-roniF-t for HELP. 

.SAV and .COM file name (default is BASIC): MYBAS(Bg) 

Do you want a mar-? (Y or Hi default is N)! \(En) 

.MAP name (default is same as .SAU name): /Ul^ir) 

Backsjrourid or Foredround ? (B or F» default is B): F(bet) 

Do you want PRINT USING? (Y or Nf default is Y)t Yfflr) 

Do you want CALL support? (Y or NJ default is N): N(e5) 

Sinale or Double r-recision math? (S or DJ default is S): DCret) 

Arithmetic hardware (NONEf EAEr ElSr FISf or FPU? default is NONE): EIS(SIl) 

Do you want the transcendental functions? (Y or N» default is Y): Y(SE) 

Do uou want the SUB command? (Y or N» default is Y): YCret) 

Do you want the RESEQ command? (Y or N. default is Y): YCbIt) 

Do you want lond error messasies? (Y o?- Nf default is Y): Y(rIt) 

Overlay structure type (1» 2r 3» 4. or 55 default is l)t 3 (pet) 

The followin!3 GLOBALS will be undefined. These 

errors may be ignored. 

..UAC$j .,NRC$. and ..MSP* (from no CALL). 

To create the BASIC that you have Just defined r 

•';ype •BYE<ret>" after BASIC prints 'READY*. When the system 

:>rompt5 for int-utr tyr-e '(SMYBAS^ret:;* to link the new BASIC. 

See the User's Guide for instructions on running 

BASIC in the Fore?S round. 

Figure 2 Sample Dialogue for Foreground 
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READY 
tiYE(Ba) 

.gMYBftS(pT) 



.R LINK 

*MYB AS T /U=/R J 1 200// 

*BSPTRD . BSPAT , BSROD 

«BSRlDrBSPRO 

*BSCLIN 

*SU01ID»BS0T0ri.EISrBS0TlD,EIS 

xSUIOPRrSUIOPO 

#SUXIIirBSXOAfBSXOB.BSXlAfBSXlB/0;i 

«BSPRlfBSCLSN 

*sux2irifBsxa/o:i 

*SUE 1 in » BSEO » BSEl , BSKE YS/0 : 1 

xBSCMP t BSSUB » BSRSQ 

)l<SI.IDTCM/Otl 

«BSERR»BSERML/0;i 

*SUI MP , BSFUNC > SUOPT/0 : 2 

x// 

"LINK--U) -Undefined alobals: 

..UAC* 

. . NRC* 

..MSP* 



♦ FRUN MYBAS/N;30Q0.(bE) 



F> 

BASIC-ll/RT-11 V02-03 

OPTIONAL. FUNCTIONS (ALLr NONEt OR INDI^iItiUAD? (CTrU?) A (eB) 

READY 

10 PRINT 'UIE ARE RUNNING IN FG NQU'lSl) 

RUNNH (gjl) 

UE ARE RUNNING IN FG NOW 

READY 
BYE^Il) 

B> 

UNLOAD FG<En) 



Figure 2 Sample Dialogue for Foreground (Cont.) 

4.4 Installation Instructions 

The BASIC-ll/RT-11 software kit is distributed in the following forms: 
1 RK05 disk 
1 RK06 disk 
1 RLOl disk 

1 9 -track magtape 

2 diskettes 

2 diskettes 
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When you receive the software kit, mount the distribution media 
{write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a safe 
place. Use your own copy of the software for the following 
installation procedure. 

If a version of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC. SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
similar to this one: 



. COPY DX .1. ; B ASRK . SAU UK t (SH) 
You can now execute BASIC by typing: 
.R BAS8K<Rg) 



If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RKU5 or RK06 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 

♦ CQPY/SETDATE RKi;H<.* SY;(aE) 

for non-magtape distribution media, and 

. COPY RKi;iK>)K sy;(b1i) 

for magtape distribution medium. 

Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 

( BASIC. SAU ] 
fi In em . tijF' I 

If your system device is a diskette or DECtape, your BASIC software 
kit consists of two volumes. The first volume contains all the .SAV, 
•BAS, .DAT, and .MAC files. The second volume contains all the .OBJ, 
.EAE, .EIS, .FIS, and .FPU files. 

NOTE 

If your system device is DECtape, follow 
this procedure for diskette-based 
systems, but substitute DT for DX in the 
examples that follow. 

First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 

.ASSIGN Dxi: dk:(r|j) 



Next, run BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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. R BASIC@I) 

BASIC-ll/RT-11 U02-02 

OPTIONAL FUNCTIONS <ALL.» NONE» OR INDIVIDUAL)? A (rB> 

READY 

RUN SUCNFG@I) 

BASIC-ll/RT-11 V02 Conf idurstion ProsSrani 

Type "?<ret>" after ana proitiF-t for HELP. 

,SAV and ,COH file name <default is EiASIO: BftSSh (EH) 

Do you want a map? (Y or N? default is N)J N<B^ 

Background or Foreground ? <B or F» default is B); B @|) 

Do you want PRINT USING? (Y or Hi default is Y): N (§15 

Do aou want CALL support? (Y or Hr default is N)! N (slj) 

Single or Double precision math? (S or D5 default is S): S<5E) 

Arithmetic hardware (NONE» EAE» EIS» FISf or FPU» default is NONE)! NONETS 

Do aou want the transcendental functions? (Y or N5 default is Y): N @5 

Do aou want the SUB command? <Y or Nf default is Y): N @£i 

Do you want the RESEQ command? CY or Hr default is Y): N @t) 

Do aou want lon^ error messages? <Y or Mr default is Y)J N ^IJ) 

Overlay structure type (1» 2> 3» 4j or 5; default is 1): 2 glj) 

The following CLOBALS will be undefined. These 

errors may be isinored. 

..PRU* (from no PRINT USING). 

..UAC$f ..NRC*!- and ..MSPit (from no CALL). 

t?nc'T_ cTfci- nnc ^ atam- ai nj^iA. £"XF' r 3r':d 

AL06 (from no transcendental functions). 
..SUB$ (from no SUB command). 
..RES* (from no RESEQ command). 

To create the BASIC that you have Just defined » 
type "BYEiret;;' after BASIC prints "READY". When the system 
prompts for input? type "@EASSM<ret> " to link the rrew BASIC. 
You may tape "R BASSM<ret>" to run it. 

READY 

Figure 3 Sample Dialogue for Backgroun(3 

When the dialogue program finishes, exit from BASIC an<J copy the new 
in(3irect file to your system (3evice: 

. COPY BASSii.COM DXOJBASSh * COH (gjl) 

Now remove the first volume from drive 1 and mount the second volume 
there. Execute the indirect file to link BASIC, as Figure 4 shows. 
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>eDXO;BASSM.COH^H) 



.R LINK 

*BASSM=/E 11000// 

♦BSF-TRS f BSF'AT , BSROS 

♦BSRlSrBSPRON 

«BSCLIN 

*SU01ID»BS0T0S 

*SUI OPR . SUIOPO , SUDTCM 

*BSXOA , ESXOB f BSX2 , BSX 1 A 

*BSXlBrBSPRlNrBSCLSN 

*BSEO,BSCMP 

JKBSSUBNrBSRSQN 

*SUE:1ID »BSE1 .BSKEYS/0 1 1 

*BSERR.BSERMS/0J1 

*SUI MP f BSFUNC r SUOP T/O 1 2 

«// 

?LINK-U~Uridefiried jnobslsl 

♦.UAC$ 

..SUB* 

..RES* 

. . PRU* 

. . NRC* 

..MSP* 

Figure 4 Linking BASIC 

Next, copy the resulting .SAV (or .REL for foreground) file to your 
system device, and reassign DK: to DXO:. 



. COPY BASSH.SAV DXOtBASSM.SAM (Hi) 

. ASSIGN dxq; dk:(b1i) 
You can now execute your new version of BASIC: 
. R bassm(b1i) 

BASIC-ll/RT-11 V02-03 

OPTIONAL FUNCTIONS (ALLf NONE» OR INDIVIDUAL)? 



5.0 THE CONVERTING PROGRAM 

The BASIC software kit contains a converting program, SUCVT, that 
helps you modify programs written under BASIC/RT-11 VOlB so that they 
execute properly under BASIC-ll/RT-11 V2. Use this program to modify 
all VOIB BASIC programs that contain any of the following items: 

• Virtual arrays 

• User-defined functions that return strings 

• REM statements that include a backslash (\) 
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• BIN or OCT functions that do not contain parentheses 

• Line numbers greater than 32767 

• DATA statements on multi-statement lines 
9 CHR$ or STRS functions 

• RANDOMIZE statements 

• CALL statements 

See Section 2.0 of this document for a summary of how the items listed 
above have changed in V2 BASIC. 



5.1 Starting the Converting Program 

To use the converting program, first make sure that the following two 
programs, which are provided in the software kit, reside on your 
system device: 

1. SUCVT.BAS 

2. SUCVTl.BAS 

Then Start BASIC. Respond to the READY prompt by typing: 

RUN SUCi^T @I) 

The converting program first requests the name of the file you need to 
convert. Enter the input file specification in the standard RT-11 
format (dev: f ilnam. typ) . Then the program requests the name to be 
assigned to the resulting converted program. Enter the output file 
specification. If you type only the RETURN key tor the output file 
name, the converting program examines the input file but does not 
create a converted output file. If you omit the file type in the 
input or output file specification, the converting program uses .BAS. 
The following is an example of the initial dialogue with the 
converting program: 

RUN SUCVT^ll) 

INF'UT FILE NAME? CUTEST (Ell) 
OUTPUT FILE NAME? Cv^QUTCail) 

Next, the converting program requests the items you need to check for 
V2 BASIC compatibility (a complete list of the possible items is 
reproduced at the beginning of Section 5,0): 

WHICH FEATURES WOULD YOU LIKE TO CHECK (ALL* INDIUIDUAL SELECTION)? 

To check all possible items for V2 BASIC compatibility, type an A. 
Typing only the RETURN key is equivalent to typing an A. If you type 
an A (or a RETURN), the converting program begins to examine the input 
file. 

If you type an I, the converting program lists each feature 
separately. If you need to examine a particular item, type a Y (or a 
RETURN). If you do not need to check a feature, type an N. The 
following is a sample dialogue: 
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UHICH FEATURES WOULD YOU LIKE TO CHECK (ALL, INDIVIEiUAL SELECTION)? 1(5© 

VIRTUAL ARRAYS (Y OR N) ? Y ^S) 

DEF STATEMENTS(Y OR N) ? Y(5et) 

REM STATEMENTS (Y OR N) ? N6^ 

BIN AND OCT USAGE<Y OR N) ? Y<b1!) 

STR* AND CHR* USAGE (Y OR N) ? Y(BrB 

DATA STATEMENTSCY OR N) ? YCSlr) 

RANDOMIZE STATEMENTS (Y OR N) ? NCgir) 

CALL STATEMENTS (Y OR N) ? Y( 



As a result of the dialogue shown above, the converting program would 
check all items except REM and RANDOMIZE statements. When you respond 
to the last line of the dialogue, the converting program begins to 
examine the input file. 



5.2 Interacting with the Converting Program 

As the converting program examines the input file, it searches for the 
items that you requested in the dialogue. When it finds an occurrence 
of a requested item, it prints the item (in most cases) and gives you 
an opportunity to modify a program line or add new program lines. 

When the converting program finds a virtual array OPEN statement, it 
prints the existing array name and requests a new array name. If you 
type just the RETURN key, the converting program repeats the request. 
If you type LIST, the converting program prints the program line that 
contains the OPEN statement, then repeats the request for a new array 
name. When you type a new virtual array name, the converting program 
rep-..ac8S aj.j. occurrences of the existing name with the new name. Make 
sure that the new name you type is not used already as a variable in 
the program. After you enter a new virtual array name, the converting 
program requests a channel number for that array. If you type only 
the RETURN key, the converting program repeats the request. Make sure 
the channel number you enter is in the range 1 to 12 and is not used 
in any OPEN statement already in the program. 

When the converting program finds a DEF statement, it prints the 
existing function name and requests a new function name. If you type 
just the RETURN key, the converting program retains the existing 
function name and continues processing the input file. If you type 
LIST, the converting program prints the program line that contains the 
DEF statement, then repeats the request. When you type a new function 
name, the converting program replaces all occurrences of the existing 
name with the new name. Again, make sure that the new name you type 
is not used in any other DEF statement in the program. 

The converting program automatically corrects program lines that 
contain REM statements with a backslash {\) and those that use the BIN 
or OCT functions without parentheses. For REM statements, the 
converting program substitutes the words "BACK-SLASH" for the actual 
backslash character (\) . For BIN and OCT functions, the converting 
program supplies the missing parentheses. The converting program does 
not request any information from you when it examines REM statements 
and BIN and OCT functions. 

The converting program always checks the line numbers in your program 
to see if there are line numbers greater than 32767. If the 
converting program detects such a line number, it prints the line 
identified by that line number and requests a new line number for it. 
Respond by typing a new line number; do not retype the entire 
statement on that line. Note that if you do not enter a new line 
number that is less than or equal to 32767, the program cannot execute 
under V2 BASIC. 
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When the converting program finds a CHR$ or STR$ function, a CALL or a 
RANDOMIZE Statement, or a DATA statement that is on a multi-statement 
line and is not the last item, it first prints the appropriate warning 
message from the following list: 

WARNING! FUNCTION CHR* HAS CHANGED 

WARNING! FUNCTION STR* HAS CHANGED 

CALL INTERFACE HAS CHANGED 

FUNCTION OF RANDOMIZE STATEMENT HAS CHANGED 

DATA STATEMENT NOT LAST 

Then the converting program prints the line that contains the function 
or statement and requests a new line. If you type only the RETURN 
key, the converting program leaves the existing program line 
unchanged. If you type a new program line, the converting program 
deletes the original line and inserts the new line. The converting 
program continues to request new lines so that you can properly modify 
your VOIB program. Make sure that the new lines you type do not have 
the same line numbers as existing program lines, except for the line 
number of the deleted line. When you are finished, respond to the new 
line request by typing just the RETURN key. 

When the converting program finishes examining the input file it asks 
if you need to convert another program: 

CONVERSION COMPLETE. 

ANOTHER COnyERSION? (Y OR N) ? 

Type a Y (or the RETURN key) to restart the converting program. Type 
an N to terminate the program and return control to BASIC. 



5.3 Converting a Sample Program 

This section contains a sample VOIB BASIC program, a reproduction of 
the converting program dialogue, and a listing of the resulting 
converted file. Read the dialogue carefully. Then compare the VOIB 
BASIC program with the V2 BASIC version. 

Figure 5 is a listing of a VOIB BASIC program called CVTEST.BAS. 
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100 DEF FNV(S)=CHR*(S) 

200 DEF FNX(T)=T+T"2 

300 OPEN 'TEST1.DAT' AS FILE #6 

400 OPEN 'TEST2.DAT' FOR 0UTPUT(4) AS FILE #4 

500 OPEN 'TEST3.DAT' FOR OUTPUT AS FILE VF1(25) 

600 OPEN 'TEST4.DAT' FOR OUTPUTdO) AS FILE VF2Z(25) 

700 OPEN 'TEST5.DAT' FOR OUTPUT AS FILE VF5*(64) 

750 OPEN 'TEST6.DAT' AS FILE MFA*(6)=16 

800 REM TEST PROGRAM FOR VI B 

900 REM CONTAINS A \ FOLLOWEDBYMORETEXT 

1000 DATA 'NOT','AT'.'END'»'OF'»'A'f'LIN£'\GO TO 1100 

1100 K=0CT<'707') 

1200 PRINT K 

1250 PRINT K+yFl(4) 

1300 K=0CT'707' 

1400 PRINT K 

1450 PRINT K+VF2<3) 

1500 K=BIN( '101010') 

1600 PRINT K 

1700 K=BIN'101010' 

1800 PRINT K 

1900 K=BIN'10101'+12 

2000 PRINT K 

2100 P»='GTY'8FNy<5) 

2200 PRINT FNX(9) 

2300 PRINT FNy(6),FNX<yFl(7)) 

2400 LET VF5<5)='N0UIS THE ' 8STR*<FNX( 1 ) ) 

2500 RANDOMIZE 

2600 CALL 'HYPOT'(GfK,Z> 

2800 CLOSE MFl 

2900 CLOSE VF5 

60000 END 



Figure 5 VOlB BASIC Program 

Figure 6 is a sample dialogue with the converting program. Note that 
all the possible features are to be checked for V2 BASIC 
compatibility. 
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READY 

RUN SUCVTdll) 

INPUT FILE NAME? CUTEST ^ 

OUTPUT FILE NAME?~ cX'OUT(gll) 

WHICH FEATURES WOULD YOU LIKE TO CHECK <ALL, INDIVIDUAL SELECTION)? I @£) 

VIRTUAL ARRAYS(Y OR N) ? Y(b1i) 

jucr o I H I tncN I OS T un w/ r i mjcij 

REM STATEMENTS' <Y OR N) ? Y(E) 

BIN AND OCT USAGE (Y OR N) ? Y(bE' 

STR* AND CHR* USAGE (Y OR N) ? Y^jj) 

DATA STATEMENTS (Y OR N) ? Ylgjl) 

RANDOMIZE STATEMENTS (Y OR N) ? Yjll) 

CALL STATEMENTS <Y OR N) ? Y(b1i) 

FUNCTION name; FNV 
NEW name: ? FNV$(all) 
FUNCTION NAME5 FNX 
NEW name; ? LIST@l£l 
200 DEF FNX<T)=T+T"2 

NEW name; ? (eli) 

VIRTUAL ARRAY NAME VFl 

NEW NAME ? C<m) 

CHANNEL NUMBER ? idjl) 

VIRTUAL ARRAY NAME UF2% 

NEW NAME ? C%(el£> 

CHANNEL NUMBER ? 2(glB 

VIRTUAL ARRAY NAME UF5* 

NEW NAME ? C»(S1I) 

CHANNEL NUMBER ? 3^15 

VIRTUAL ARRAY NAME VF6« 

NEW NAME ? Cl»(§15 

CHANNEL NUMBER ? 5 (JH) 

LINE NUMBER GREATER THAN MAX 

OLD line; 60000 END 

NEW LINE number;? 32000 @g) 

WARNING! FUNCTION CHR4 HAS CHANGED. 

OLD LINE ; lOO^DEF FNV*(S)=CHR*(S) 

Ntw LiNt. i r^mv 

DATA STATEMENT NOT LAST 

OLD LINE ; 1000 DATA 'NOT' . ' AT' » 'END' r 'OF' » 'A' > 'LINE'NGO TO 1100 

NEW LINE ; ? lOQO GOTO llOQdlJ) 

NEW LINE ; ? 1010 DATA 'NOT' > 'AT' > 'END' > 'OF' > 'A' > 'LINE'@) 

NEW LINE ; ?(b1i) 

WARNING! FUNCTION STR* HAS CHANGED. 

OLD LINE ; 2400 LET C*<5)='N0WIS THE ' 8STR$(FNX< 1 ) ) 

NEW LINE ; ? (gl5 

FUNCTION OF RANDOMIZE STATEMENT HAS CHANGED 

OLD LINE ; 2500 RANDOMIZE 

NEW LINE ; ? 50 RANDOMIZE ^f& 

NEW LINE ; ? (M> 

CALL INTERFACE HAS CHANGED 

OLD LINE ; 2600 CALL 'HYPOT ' (GrK,Z) 

NEW LINE ; ?^ 

CONVERSION COMPLETE. 

ANOTHER CONVERSION? (Y OR N) ? N<M> 

READY 

Figure 6 Converting Program Dialogue 

Figure 7 is the listing of the resulting converted program, called 
CVOUT.BAS: 
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OLD CV0UT(H1D 

READY 
LIST (eg) 



CVOUT 



17-AUG-77 11J37J19 



50 RANDOHIZE 
100 DEF FNV*<S)=CHR*(S) 
200 DEF FNX(T)=T+T'*2 
300 OPEN 'TEST1.DAT' AS FILE *6 
'TEST2.DAT' 



400 OPEN 
500 OPEN 
600 OPEN 
700 OPEN 
750 OPEN 



FOR OUTPUT AS FILE *4f FILESIZE 4 

TEST3.DAT' FOR OUTPUT AS FILE #1 \ DIM #1»C(25) 

'TEST4.DAT' FOR OUTPUT AS FILE #2» FILESIZE 10 \ DIH #2rCX(25) 

'TEST5.DAT' FOR OUTPUT AS FILE #3 \ DIM #3,C«(64)=32 



'TEST6»DAT' AS FILE #5 \ DIM #5fCl*(6)=16 
800 REM TEST PROGRAM FOR VIB 

900 REM CONTAINS A ■BACK-SLASH" FOLLOUEDBYMORETEXT 
1000 60 TO 1100 

1010 DATA 'NOT' » 'AT' » 'END' » 'OF' » 'A' » 'LINE' 
1100 K=0CT<'707') 
1200 PRINT K 
1250 PRINT K+C(4) 
1300 K=0CT('707') 
1400 PRINT K 
1450 PRINT K+C5i<3) 
1500 K=BIN( '101010') 
1600 PRINT K 
1700 K=BIN( '101010') 
1800 PRINT K 
1900 K=BIN( '10101' )+12 
2000 PRINT K 
2100 P»='BTY'8FNV*(5) 
2200 PRINT FNX<9) 
2300 PRINT FNV»<6)»FNX<C(7)) 
2400 LET C$<5)='N0UIS THE ' SSTR$(FNX< 1 ) ) 
2600 CALL 'HYPOT'(GrK»Z) 
2800 CLOSE 1 
2900 CLOSE 3 
32000 END 



READY 



Figure 7 V2 BASIC Program 



5.4 Coapiling the Converting Program 

If you need to use the converting program frequently, compile the 
program so that it executes more efficiently. See Figure 8 for the 
commands to do this. 
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OLD SUCVTiil) 

READY 
COMPILE (all) 

READY 

OLD SUCVTl(Rg) 

READY 
COMPILE ill) 

READY 

Figure 8 Compiling the Converting Program 
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conservation is more important than speed. Use type 3 for 
diskette-based systems if memory is at a premium. Use overlay type 4 
if you must strictly conserve memory. BAS8K.SAV, the smaller version 
of BASIC supplied in the software kit, uses overlay type 5. It has 
many small overlay sections and, therefore, executes slowly. Use type 
5 only for 8K systems. 



4.2,2 Arithmetic Hardware Support - The versions of BASiC provided in 
the software kit do not support special arithmetic hardware. Specify 
EAE if your system has the KEll-A or KEll-B Extended Arithmetic 
Element. Specify EIS to support the KEll-E Extended Instruction Set. 
Use EIS also for any PDP 11/34, 11/45, 11/50, 11/55, or 11/70 without 
the FPU Floating Point Unit. Specify FIS if your system has the 
KEll-F or KEV-11 Floating Instruction Set. Specify FPU to include 
support for the FPU Floating Point Unit. Use FPU also for any PDP 
11/60 without the FPll-E Floating Point Unit. 



4.2.3 Foreground Execution - You must link BASIC to execute in the 
foreground with either the FB or XM monitor. To do this, simply type 
an F in response to the dialogue program's "Background or Foreground?" 
prompt. To execute BASIC in the foreground, use the FRUN command with 
the /N option. Section 4.3 contains an example of linking BASIC and 
executing it in the foreground. 



4.2.4 Assembly Language Routines - The versions of BASIC provided in 
the software kit do not support the CALL statement for assembly 
language routines. To include CALL support, you must first add the 
names of your assembly language routines to BSCLI.MAC, as described in 
the BASIC-ll/RT-11 User's Guide. Then assemble the three .MAC files 
together, supplying any file name for the resulting object file: 

> macro/object: MYCLI BSMAC+BSftSM+BSCLKall) 

ERRORS detected: 

Next, assemble your assembly language routines. You can place more 
than one routine in an object file. Type a Y in response to the 
dialogue program's "Do you want CALL support?" prompt. The dialogue 
next requests the module names. On the first line, enter the name of 
the .OBJ file you specified in the MACRO assembly shown above. On the 
next lines, enter the names of the .OBJ files that contain your 
assembly language routines. On the last line, enter BSCLLB if your 
assembly language routines use any routines supplied by BASIC (see the 
BASIC -11/RT-ll User's Guide ). Finally, type only the RETURN key to 
terminate the list of module names. The following example shows the 
CALL support section of the dialogue: 

Do you want CALL suPF-ort? (Y or Nr default is N) : Y(all) 

Enter module names (one per line)* MYCLI (ret) 

Module name? MODl^D 

Module name: MQD2(^ 

Module name: MOn:^(RFf) 

Module name: Mnri4(RiT) 

Module name: BSCLLBdH) 

Module name: (BED 
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4.2.5 Optional Features - You can link BASIC to add or delete support 
for any optional features. See the BASIC-ll/RT-11 User's Guide for a 
discussion of the optional features. The text of the dialogue program 
(see Figure 1) lists the optional features you can add or delete at 
link time. 



4.3 Sample Dialogue 

The sample dialogue reproduced in Figure 2 shows how to link BASIC to 
run in the foreground. This example also requests a wide map listing 
(with /M) , and adds support for EIS arithmetic hardware. The example 
then shows how to execute the indirect file and how to run the new 
version of BASIC in the foreground. 

. R BASlC(m) 

BASIC-n/RT-ll V02-02 

OPTIONAL FUNCTIONS (ALL» NONE. OR INDIVIDUAL)? A (Sir) 

READY 

RUN SUCNFG(b1i) 

BASIC-ll/RT-11 y02 Confiauration Program 

Typ-e "T^ret:;" after ana prompt for HELP. 

.SAV and .COM file name (default is BASIC): MYBAS (bIi) 

Do aou want a map? (Y or NJ default is N)! YCbet) 

.MAP name (default is same as .SAV name): /Uldg) 

Backslround or Forearound ? (B or Ff default is B): F(aa) 

Do you want PRINT USING? (Y or N5 default is Y): YCret) 

Do you want CALL support? (Y or N? default is N); N(BiT) 

Sinale or Double precision math? (S or Df default is S): D (ret) 

Arithmetic hardware (NONE? EAE. EIS. FIS. or FPUJ default is NONE)! EI5(all) 

Do you want the transcendental functions? (Y or N5 default is Y)? Y(ret) 

Do you want the SUB coitunand? (Y or N. default is Y): YCret) 

Do you want the RESEQ command? (Y or N. default is Y): Y(ret) 

Do you want lona error messages? (Y or N. default is Y): Y(ret) 

Overlay structure type (1. 2. 3. 4. or 5. default is 1): 3 (ret) 

The following GLOBALS will be undefined. These 

errors may be ignored. 

..UAC$. ..NRCt. and ..MSP$ (from no CALL). 

To create the BASIC that you have Just defined. 

type "BYE^ret:!' after BASIC prints "READY". When the system 

prompts for input, type "(IMYBAS<ret>' to link the new BASIC. 

See the User's Guide for instructions on running 

BASIC in the Foreground. 

Figure 2 Sample Dialogue for Foreground 



16 



BASIC-ll/RT-11 INSTALIATIOM GUIDE 



READY 
.eMYBAS@l) 



.R LINK 

«HYBAS » ./W==/R ; 1 200// 

*BSPTRD f BSPAT r BSROD 

*BSRlDrBSPRO 

*BSCLIN 

*SU01IDfBSOTOD.EISrBSOTin.EIS 

«SUIOPR»SUIOPO 

«SUXID»BSXOArBSXOB»BSXlAfBSXlB/0:i 

«BSPRlrBSCLSN 

*SUX2IDtBSX2/0;1 

*SUEliri.BSEOtBSElrBSKEYS/0:i 

^BSCMP , BSSUB J BSRSQ 

*SlJEiTCM/Otl 

*BSERRfBSERML/0:i 

)«SUIMP f BSFUNC , SUOPT/0 1 2 

«// 

"LINK-U-Uridefined Slobslst 
..UAC* 
. ,NRC$ 

. . MSP$ 



.FRUN mybas/n;30oq.(r1i) 



F> 

BASIC -11/RT-ll V02-03 

OPTIONAL FUNCTIONS <ALLf NONEj OR INDIVIPUAL)? (gJlUE) A (ill) 

READY 

10 PRINT 'UE ARE RUNNING TN Ffi NnU'CREfi 
RUNNH (eij) 

WE ARE RUNNING IN FG NOW 

READY 
BYE(rSt) 

B> 

UNLOAD FG(fi^ 



Figure 2 Sample Dialogue for Foreground (Cont.) 

4.4 Installation Instructions 

The BASIC-ll/RT-11 software kit is distributed in the following forms: 
1 RK05 disk 
1 RK06 disk 

1 magtape (7- or 9-track) 

2 diskettes 
2 DECtapes 
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When you receive the software kit, mount the distribution media 
(write-protected, if possible) and copy all the files onto an empty 
disk or tape. Then store the original distribution media in a safe 
place. Use your own copy of the software for the following 
installation procedure. 

If a version of BASIC provided in the software kit (BAS8K.SAV, 
BASICD.SAV, or BASIC. SAV) is suitable for your application and you do 
not need to modify it, simply transfer the appropriate file from your 
copy of the distribution medium to your system device. Use a command 
similar to this one: 

. COPY DXltBASSK.SAt^ DK ; (Hi) 

You can now execute BASIC by typing: 

. R BftSBKiSll) 

If a version of BASIC provided in the software kit is not suitable for 
your application, you must use the program SUCNFG to relink BASIC. If 
your system device is an RK05 or RK06 disk, transfer all the files 
from your copy of the distribution medium to your system device. Use 
a command similar to this one: 

. COPY RK1.;»>:» riKt^JT) 

Run the dialogue program as described in Section 4.2. Then delete all 
the new files on your system device, except the new version of BASIC 
that you just created. Use this command to delete all the new files 
except for the new BASIC file: 

I BftSIC.SftU I 
> (Hi) 
f i IriBin. t'jjp I 

If your system device is a diskette or DECtape, your BASIC software 
kit consists of two volumes. The first volume contains all the .SAV, 
.BAS, .DAT, and .MAC files. The second volume contains all the .OBJ, 
.EAE, .EIS, .FIS, and .FPU files. 

NOTE 

If your system device is DECtape, follow 
this procedure for diskette-based 
systems, but substitute DT for DX in the 
examples that follow. 

First, mount the first volume in drive 1. Assign DK: to that unit, 
as follows: 

♦ ASSIGN nxi; iiK:(aIi) 

Next, run BASIC and SUCNFG, and answer the questions from the dialogue 
program. A sample run is reproduced in Figure 3. 
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UPDATE NOTICE No. 1 

BASIC-ll/RT-11 Installation Guide 
Order No. DEC-11-LIBTA-A-DNl 

March 1978 

NEW AND CHANGED INFORMATION 

This update includes information to reflect 
the release of BASIC-ll/RT-11 Version 2 for 
the RLOl disk. 

Copyright @ 1978 Digital Equipment Corporation 

INSTRUCTIONS 

Place the following pages in the BASIC-ll/RT-11 
Installation Guide as replacements for, or ad- 
ditions to, current pages. The changes made 
on replacement pages are indicated in the out- 
side margin by change bars ( | ) for additions 
and by bullets ( • ) for deletions. 

Old Page New Page 

Title Page/Copyright Title Page/Copyright 
15 through 18 15 through 18 
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